OpenBuildings™ Designer Readme

Vytvoření uživatelského balíčku

.msi je preferovaný formát pro vytváření uživatelských balíčků. Soubor .msi je snadno konfigurovatelný a jakmile probíhá instalace produktu, tak soubor .msi nepotřebuje další parametry pro provedení tiché instalace na pozadí.

Existuje řada externích nástrojů, které vám pomohou vytvořit MSI, některé z nich jsou zde vypsány:
  • WiX (Windows Installer XML)
  • InstallShield
  • Rozšířený instalátor
  • InstallAware
Poznámka: Bentley nedoporučují používat žádný dílčí nástroj na výrobu MSI balíčků. Příklady zde uvedené slouží pouze pro informační účely.

Následující příklad ukazuje, jak vytvářet uživatelské balíčky pomocí aplikace WiX.

WiX volně šiřitelný nástroj kategorie open-source. WiX sám neposkytuje IDE (Integrated Development Environment), ale existuje řada volných i komerčních IDE, které je možné používat spolu s WiX pro vytváření MSI balíčků. Vybraná IDE jsou uvedena v tomto seznamu:
  • MSI Factory
  • Microsoft Visual Studio
  • WiXEdit

Při vytváření MSI balíčků, je třeba soubory identifikovat do jedné nebo všech těchto kategorií:

  1. Programové soubory pro OpenBuildings Designer - Toto je sada souborů, které je potřeba umístit do programového adresáře OpenBuildings Designer. Umístění může být například v adresáři C:\Program Files\Bentley\OpenBuildings Designer\. Zde jsou základní konfigurační (.cfg) soubory.
  2. Pracovní sada soubory pro OpenBuildings Designer- Zde jsou sady souborů, které je třeba rozmístit do OpenBuildings Designer Konfigurace. Umístění může být například v adresáři C:\ProgramData\Bentley\OpenBuildings Designer\. Zde jsou zpravidla dodatečná data nebo soubory z Pracovní sada.
  3. Další soubory - Tyto soubory se mohou spojovat s jakýmkoliv produktem. Zde jsou právě distribuovány spolu s OpenBuildings Designer. Příkladem mohou být knihovny, datové soubory a obecné soubory, které lze požívat i s jinými produkty.
Soubory z každé výše uvedené kategorie by měly být aranžovány podle správné adresářové hierarchie. Identifikátor adresářů (refer Tabulka adresářů) pro nejvýše položený uzel u každé kategorie by měl být Public Property MSI balíčku, to znamená, že Identifikátor adresářů by měl být ve velkých písmenech. Následujte příklady pro konfigurační soubory pod Identifikátorem adresářů podle jejich typu:
  • Programové soubory (.cfg soubory): MyCompanyPolicy.cfg a MyCompanyWorkSet.cfg. Tento typ souborů je potřeba dodávat v programovém adresáři OpenBuildings Designer. Proto umístěte tuto sadu do adresáře s identifikátorem MYCOMPANY_CONFIGURATIONFILES.
  • DGN soubory (soubory Pracovní sada): MyWorkSetLibrary.dgn a MyPartnerWorkSetLibrary.dgn. Tento typ souborů je třeba umístit do adresáře OpenBuildings Designer's Konfigurace. Proto umístěte tuto sadu do adresáře s identifikátorem MYCOMPANY_CONFIGURATION.
  • Sada souborů, které je možné dodat na počítač kdykoliv. Proto umístěte tuto sadu do adresáře s identifikátorem MY_EXTRAFILES.

Tento druh samostatných souborů podle rozmístění umožní snadnou konfiguraci balíčku. Není nutné všechny soubory stejného typu v jednom balíčku. Je praktické zabalit související soubory do jednoho balíčku, aby bylo možné instalaci a údržbu při práci provádět s jedním datovým souborem.

Parametry příkazové řádky

Jakmile je MSI vybrán, instalace OpenBuildings Designer ví potřebné identifikátory pro konfigurační adresáře. Pokud provedete editaci v okně pro zadání parametrů Příkazové řádky, vypíší se použitelné identifikátory.

Zde je příklad použití parametrů Příkazové řádky:
  • INSTALLFOLDER_CONFIG_FILES a INSTALLFOLDER_WORKSET_FILES - Místo, kam se OpenBuildings Designer nainstaluje, je při instalaci určeno pomocí cesty Windows standardní adresář. Proto instalátor zkouší nabídnout cestu relativně k OpenBuildings Designer adresářům nebo podle pravidel pro své standardní adresáře. Pro tyto parametry příkazové řádky mohou být konfigurační soubory nainstalovány do složky Config\System, pokud bude nastavena hodnota [InstallDirectory]<název_produktu>\config\system\. Podobně budou soubory Pracovní sada nainstalovány do místa, kde je Pracovní sada podle cesty [ConfigurationDirectory]Configuration\Workspaces\MyCompany\. Standardní vlastnosti jako [InstallDirectory] a [ConfigurationDirectory] budou dostupné v rozbalovacím seznamu jako možné relativní cesty, podobně jako Windows standardní adresáře.

Názvy parametrů příkazové řádky a jejich hodnoty musí být odděleny znakem "=".

Pokud chcete přidat jiné identifikátory adresářů, klepněte na<mezerník> a pak zadejte identifikátor adresáře.